Displays a dialog for changing the keychain name, password, and settings associated with a specified keychain.

OSStatus KCChangeSettings (
    KCRef keychain
);

keychain

A reference to an unlocked keychain. Pass in NULL to specify the default keychain.

function result

A result code. The result code errUserCanceled indicates that the user pressed the Cancel button in the Change Settings dialog box. The result code errKCNoDefaultKeychain indicates that the default keychain could not be found. The result code errKCInvalidKeychain indicates that the specified keychain is invalid.

DISCUSSION

You application should not normally call the KCChangeSettings function, unless responding directly to a user's request to change keychain settings. An application cannot directly change a keychain's passphrase. For security reasons, your application can effect a change to the passphrase only by calling KCChangeSettings to allow the user to change the passphrase interactively.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)